Release 10.1A: OpenEdge Development:
Progress Dynamics Managers API Reference

insertObjectInstance

This procedure adds or updates an object instance on a container. If the object already exists on the container, the instance and its attribute values are updated accordingly. Otherwise, the instance is created.

Because an object can exist multiple times on a container, this procedure determines whether the object exists based on the object instance name. If the plForceCreateNew flag is set, a new object instance is created even if one already exists.

If an attribute value is contained in the attribute value table and is set against the instance owner, the attribute value is set against the object.

Location: ry\app\rydesmngrp.i

Parameters:

INPUT pdContainerObjectObj AS DECIMAL INPUT pcObjectName AS CHARACTER INPUT pcResultCode AS CHARACTER INPUT pcInstanceName AS CHARACTER INPUT pcInstanceDescription AS CHARACTER INPUT pcLayoutPosition AS CHARACTER INPUT piPageNumber AS INTEGER INPUT piPageSequence AS INTEGER INPUT plForceCreateNew AS LOGICAL INPUT phAttributeValueBuffer AS HANDLE INPUT TABLE-HANDLE phAttributeValueTable OUTPUT pdSmartObjectObj AS DECIMAL OUTPUT pdObjectInstanceObj AS DECIMAL Notes: None

Examples: See the registerSdoFields procedure in ry\app\rydesmngrp.i.